package org.example.flea_market_mvc.service.orders;

import org.example.flea_market_mvc.entity.Orders;
import org.example.flea_market_mvc.param.OrderParam;

import java.util.List;

/**
 * 订单服务接口
 * 处理订单全生命周期业务逻辑，包括创建、更新、查询订单等
 */
public interface OrdersService {

    /**
     * 插入新订单记录
     * @param orderParam 订单参数对象
     * @return 插入成功返回1，失败返回0
     */
    int insert(OrderParam orderParam);

    /**
     * 根据订单ID删除订单记录
     * @param id 订单ID
     * @return 删除成功返回1，失败返回0
     */
    int deleteById(Long id);

    /**
     * 更新订单记录
     * @param orderParam 订单参数对象（含更新信息）
     * @return 更新成功返回1，失败返回0
     */
    int update(OrderParam orderParam);

    /**
     * 根据订单ID查询订单记录
     * @param id 订单ID
     * @return 订单实体对象，未找到返回null
     */
    Orders selectById(Long id);

    /**
     * 查询所有订单记录
     * @return 订单实体列表
     */
    List<Orders> selectAll();

    /**
     * 购物车结算生成订单
     * @param userId 用户ID
     * @param cartItemIds 购物车项ID列表
     * @return 是否成功
     */
    boolean checkout(Integer userId, List<Integer> cartItemIds);

    List<Orders> selectByUserId(Long id);
}